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This publication introduces VM/370, and is intended for 
anyone who is interested in VM/370. However, the 
reader should have a basic understanding of IBM data 
processing. 

VM/370 (Virtual Machine Facility/370) is a system 
control program (SCP) that tailors the resources and 
capabilities of a single System/370 computer to provide 
concurrent users their one unique (virtual) machine. 
VM/370 consists of a Control Program (CP), which 
manages the real computer, a Conversational Monitor 
System (CMS), which is a general- purpose conversational 
time-sharing system that executes in a virtual machine, 
a Remote Spooling Communications Subsystem (RSCS), 
which spools files to and from geographically remote 
locations, and a Interactive Problem Control System 
(IPCS), which provides problem analysis and management 
facilities. 

The first section of the publication is an introduction; it 
describes what VM/370 can do. The second, third, fourth, 
and fifth sections describe the Control Program, Conversational 
Monitor System, Remote Spooling Communications Subsystem, 
and Interactive Problem Control System respectively. The 
appendixes include information about VM/370 
publication-to-audience relationship and VM/370-related 
publications for CMS users. 

This publication is a prerequisite for the VM/370 system library. 
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Preface 



This publication introduces and describes 
the IBM Virtual Machine Facility/370 
(VM/370) and its components, the Control 
Program (CP) , the Conversational Monitor 
System (CMS) , the Remote Spooling 
Communications Subsystem (RSCS) , and the 
Interactive Problem Control System (IPCS) . 



This publication contains five sections 
and two appendixes: 



• "Introduction" describes VM/370, virtual 
machines, and their applications. 

• "Control Program" describes how the 
VM/370 control program manages the 
resources of the real computing system. 

• "Conversational Monitor System" 
describes the facilities of CMS: problem 
solving and program development 
capabilities for interactive users. 

• "Remote Spooling Communications 
Subsystem" describes the functions and 
organization of RSCS. 

• "Interactive Problem Control System" 
describes the organization and function 
of IPCS. 

• "Appendix A: VM/370 Publication-to- 
Audience Relationship" 

• "Appendix E: Vn/370-Related Publications 
for CMS Osers" 



The reader must have a basic knowledge 
of data processing systems and definitions, 
and an understanding of virtual storage 
concepts- For information about virtual 
storage, see the student text publication 
Introduction to Illtual Storage in 
Slstem/370, GR20-4260. 



RELATED PUBLICATIONS 



Commands (General User), GX2 0-19611 

Commands (Other than General Dser) , 
GC20-19951 

CE Command Reference for General Users, 
GC20-182C 

Glossar"'' and Master Index, GC20-1813 

Operating Systems in a Virtual Machine, 
GC20-1821 

Oierator_^s Guide, GC20-1806 

IlSSSiM SHJ System Generation Guide, 
GC20-1801 

fiuicJS Guide for Users, GX2 0-19261 

S§l§ase 6 Guide, GC20-18 3U 

Bemote Sfoolin^ Communications Subsystem 
(ESCS) 0serj.s Guide, GC20-1816 

System Messages, GC20-18 08 

Si stem Programmer's Guide, GC20-1807 

l§§i]2ies Supplement, GC 2 0-1 7 57 

Terminal User2.s Guide, GC20-1810 

ISiSHSiiie Problem Control System 
(IPCS) User_^s Guide, GC 2 0-1823 

^ata Ar^^s and Control Block Logic, 
SY20-0884 

System Lc^ic and Problem De ter mination 
Guide Volume 1 Control Program (CP) , 
SY20-08862 

System Logic and Problem Determi na tion 
Guide Volume 2 Conversational Monitor 
System (CMS) , SY20-08872 

System Logic and Problem Determi na tion 
Guide Volume 3 Remote Spooling 
Communications Subsystem (RSCS) , 
SY20-08882 



III Iliiual Machine Fac il ity/37 : 



CMS Command and Macro Reference, 
GC20-1818 

CMS User's Guide, GC20-1819 



iThese three publications are available 

as a unit, GBOF-3576 
2These three volumes are available as a 

unit, SEOF-3802 



Preface iii 



In order to use the CPEREP coniBand, the 
following publications are required: 

I EM Ii£tual Machine Facili ti/37 : OLTSEP 
aM ll£2£ Is cor dins Guide, GC20-1809 

OS/VS, Cgs/VSE, VM^370 EnvironBental 
Bgcgrding, Editins, an J Printing (EREP) 
Program, GC28-0772 

The first publication provides general 
information on usage and detailed 
inforiation on command operands applicable 
only to VM/370. The second publication 
provides detailed information on the 
operands that are common to OS/YS, DOS/VSE, 
and VM/370. 

Program logic information describing the 
interface between CMS and OS/YS EREP, and 
describing OS/YS EREP, is coi 
following: 



:ainea m 



:he 



IM Virtual Machine FacilitY/370: Service 
Routines Program Logic, SY20-0882 

OS/YS, DOS/VSE, YH/370 Environmental 
Recording, Jditincf, and Printing (EREP) 
RL°£LM I-oqic* SY28-0773 



In addition, all EREP messages are 
contained in the OS/YS, POS/YSE, YM/370 
Ifilii^SIsSiai Re co rding, Editing, and 
IliiiiM (ilM) Messiaes, 0038-1045. 



MISCELLANEODS 



A complete description of YM/370 
restrictions is available in YH/370 System 
Messages and VH/370 Planninci and System 
§®S6iaii25 • 

Figure 1 is an overview of the YM/370 
library, and supplemental support, with the 
publications grouped according to their 
probable users. 

References in the text tc titles of 
related VH/370 publications are given in 
abbreviated form. 
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VM/370lmroductron 
GC20 1800 1201 



VM/370 Glossary and 
Master Index 
GC2018)3 120) 



Virtual Machine Facility/370 {VM/370) Library 

(Release 6) 



GC201810 (40) 



VM/370 CP Command 

Reference for General 

Users 

GC20-1820 136 



VM,'370 CMS Command 
and Macro Reference 
GC20-1818 (36i 



OS/VS and VM/370 
Assembler Programmt 



OS/VS- DOS/VSVM/370 
Assembler Language 
GC33-4010 (21) 



VM/370 System 
Messages 
GC20-1808 140) 



Note: 

VM .(70 Syslcm 

reQtiired for all l 
virtual machines. 



OS/VS, DOS/VSE 
VM/370 EREP 
Messages 
GC3810451 (401 



System 
Programi 



VM/370 Remote Spooling 
Communications Subsysterr 
(RSCS) Users Guide 
GC20-1816 (30 



VM/370 Planning and 
System Generation 
Guide 



VM/370 Operating 
Systems in a Virtual 
Machine 



VM/370 System 
Programmer's Guide 
GC20-t807 (36) 



Guide 
GC20-1834 



These publications are digests 
of the formats of VM/370 
commands and service programs. 
If all documents are to be 
ordered, please use Order 
No. G80F3576 





VM/370 Quick Guide for 

Usere 

GX20-1926 (361 






■ 




VM/370 Commands 
(General User) 
GX20-1961 (36) 












VM/370 Com.mands 
[Oifier ttian Genera! User) 
GX201996 (36) 





VM/370 Interactive 
Problem Control System 
(IPCS) User's Guide 
GC201823 (37) 



VM/370 OLTSEP and 
Error flecording Guide 
GC20-1809 (37) 



If all documents 
are to be ordered, 
please use Order 
No. SBOF-3802 



VM/370 System Logic 
and Problem Determination 
Volume 1 Control 
Programs (CP) 
SY20-0886 (36) 



VM/370 System Logic and 
Problem Determination 
Volume 2 Conversational 
Monitor System (CMS) 
SY200887 (36) 



VM/370 System Logic and 

Problem Determination 

Volume 3 Remote Spool'g 

Communication Subsystem 

(RSCS) 

SY200888 (36) 



VM/370 Data Areas a 
Control Block Logic 
SY20-0a84 



VM/370 Service Routines 
Program Logic 
SY200882 (371 



OS/VS and VM/370 
Assembler Program 



OS'VS. DOS/VSE. VM/370 
Environmental Recording, 
Editing, and Printing 
(EREP) Program 



Lagend: 

1-4^ Indicates that the publication is new in Release 6. 
2. The number in parentheses is the file number. 
S.T Contains information on VM/37G ER£P support. 



OS/VS, DOS/VSE, VM/370 
Environmental Recording, 
Editing, and Printing 
(EREP) Program Logic 
SY28.0773 (37). 



Figure 1. Virtual Machine Facility/370 Library 
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The entries in this Table of Contents are accumulative. They list additions to this 
publication by the following VM/370 System Control Program Product: 

• VM/370 Basic System Extensions, Program Number 57U8-XX8 

• VM/370 System Extensions, Program Number 5748-XE1 

However, the text within the publication is not accumulative; it only relates to the one 

SCP program product that is installed on your system. Therefore, there may be topics and 

references in this Table of contents that are not contained in the body of this 
publication. 
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Summary of Amendments 

for GC20-1800-9 

As Updated by GN25-04 89 

VM/370 Release 6 PLC H 



Channel-set Switching Support channel switching via CP's VARY 

PROCESSOR command or it can occur 

automatically upon detection of a severe 

New ; Program and Documentation hardware malfunction on the main (I/O) 

processor. After the switching 
For systems equipped with Channel-set operation, VM/370 continues operation in 
Switching, function has been added to uniprocessor mode. This facility 
VB/370 that allows the operator to enhances the reliability, availability 
switch channels from one processor of an and serviceability of VM/370. For 
attached processor system to the other details, refer to the topic: "VM/370 
processor. The operator can invoke Attached Processor Support." 
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Summary of Amendments 
for GC20-1800-9 
VM/370 Release 6 PLC 1 



3800 PRINTING SUBSYSTEM 



SHARED SEGMENTS 



New; Program and Documentation 

VM/370 supports the 3800 Printing 
Subsystem as a high-speed printing 
device that uses electrophotographic and 
laser technology. 

VM/370 allows virtual machines to attach 
the 3800 printer (with full 
capabilities) as a dedicated device. In 
addition, VM/370 supports the 3800 
Printing Subsystem as a real spooling 
device. 



3850 MASS STORAGE SYSTEM 



New: Program and Documentation 

VM/370 supports user minidisks on Mass 
Storage System (MSS) 3330V volumes, 
where the minidisk appears to the 
virtual machine to be defined on a 
permanently mounted IBM 3330-1 drive. 

MSS volumes may also be dedicated and 
attached to a virtual machine as either 
a 3330V or a 3330-1 device. 



New and Changed; Program 
Documentation 



and 



A new option has been 
modifies the protection 
segments. 
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VM/370 provides the option of running 
without protection against changes to 
shared segments. If a shared segment is 
specified as unprotected, any changes 
will be seen by all other users of that 
shared segment. 



REMOTE SPOOLING COMMUNICATIONS SUBSYSTEM 



LOGON/AUTOLOG/LINK JOURNALING 



Changed: Program and Documentation 

VM/370 now supports a function that will 
aid in the prevention of unauthorized 
use of virtual machines and minidisks. 

When the new option (JOURNAL operand) is 
specified, passwords cannot be entered 
on the same line as the LOGON/AUTOLOG or 
LINK commands. All unsuccessful 
attempts to do so will be recorded, when 
the threshold has been reached, the 
system administrator is notified. 



VM/370 provides a new program product 
(Remote Spooling Subsystem Networking) 
that enhances the networking facilities 
of the VM/370 system, and allows a 
VM/370 system to use the Network Job 
Interface/Network Job Entry (NJI/NJE) 
protocol. 



MISCELLANEOUS 



Changed; Documentation only 

Literary and editorial changes have been 
made throughout this publication. 

The entire "Introduction" to this 
publication has been rewritten and 
should be read in its entirety. 
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Summary of Amendments 

for GC20-1800-8 

as updated by GN25-0454 

VM/370 Release 5 PLC 12 



VARY PROCESSOR ONLINE/OFFLINE SUPPORT 



New and Chang ed: Programming support 

VM/370 attached processor (AP) provides 
support to enhance the reliability, 
availability, and serviceability of the 
158 and 168 attached processors, and the 
158 and 168 asymmetric MP systems. 

This support allows the attached 
processor to be taken offline, make 
needed repairs, and then bring it back 
online without affecting the main 
processor. 
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Introduction 



Virtual Machine Facility/370 (VM/370) is a 
system control prograa. It manages the 
resources of an IBM System/370 in such a 
way that multiple users have a functional 
simulation of a computing system (a virtual 
machine) at their disposal. 
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VM/370 Components 
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REMOTE SPOOLIHG COMMUNICiTIONS SUBSYSTEM 



The remote spooling communication subsystem 
(BSCS) is a single-user operating system 
that runs under CP. BSCS executes in one 
or more virtual machines and transfers data 
between virtual machines and remote users. 



INTERACTIVE PROBLEM CONTROL SYSTEM 
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The Virtual Machine 



A virtual machine is functionally 
equivalent to a real system. It has 
simulated hardware and software resources 
that operate in a real computer under CP. 
Each virtual machine is defined in the 
VM/370 directory; the directory describes 
its simulated storage, I/O devices, and 
console. 



CONTROL PROGRAM 



The control program (CP) executes in a real 
machine controlling the resources of that 
machine. CP is the vehicle that is used to 
create concurrent virtual machines. 
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CONVERSATIONAL MONITOR SYSTEM 



The conversational monitor system (CMS) is 
a single-user operating system (designed to 
operate in VM/370) that can execute in one 
or more virtual machines. CMS provides a 
wide range of general- purpose, 
conversational time sharing functions- 
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Figure 2. Siaultaneous Operations of Virtual Machines 



Multiple virtual Machines permit several 
systems to execute concurrently. Thus, 
production work may be run in one or more 
virtual machines while other virtual 
machines are executing: 



A terminal-oriented 
system 



conversational 



A remote spooling subsystem, which 
transmits bulk data to and from remote 
locations 

A back-release system that executes 
application programs below the current 
service level of the production system 

A current-release system with new 
program temporary fixes (PTFs) applied 

A new release or option that needs to be 
generated and tested 



A conversion test from one operating 
system to another, such as from DOS/VSE 
to 0S/VS1 



VIHTOAL STORAGE 



A virtual storage system can simulate real 
storage within a range of from 8K (8192) 
bytes to 16 megabytes (the maximum virtual 
storage size) . The virtual storage for 
each virtual machine is defined in the 
VM/370 directory. 

Virtual storage extends beyond the size 
of real storage and is not limited by the 
amount of real storage. It is possible for 
the combined virtual storage of several 
virtual machines to be greater than the 
real storage. 
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virtual storage can be fflanaged and 
protected through segmentation. Each 
segment is 64K and there are from 1 to 256 
segments depending on the size of virtual 
storage. 

As a storage protection feature for all 
virtual machines, page and segment tables 
are accessible only to VM/370. One virtual 
machine operating system can not access or 
alter the virtual storage of another 
virtual machine. 

Refer to the "Control Program" section 
of this publication for more detailed 
information- 



VIETOAL PROCESSOR 



devices. In either case, CP converts the 
virtual address to its real counterpart and 
performs any necessary data translation. 
In addition, VM/370 allows the same virtual 
address to be used by multiple users. 

VM/370 supports several types of 
virtual-tc-real device mappings: 

Dedicated devices 

Virtual disks 

Virtual unit record devices 

Virtual transmission control units 
(virtual lines) 

Channel-to-channel adapters 



CP provides each virtual machine a single 
virtual processor to execute instructions 
and receive interruptions. In actuality, 
this virtual processor is the shared use of 
the real processor, CP simulates the 
privileged instructions, and the real 
processor executes the nonprivileged 
instructions. 



VIRTUAL SYSTEM CONSOLE 



DEDICATED DEVICES 



Devices with a one-to-one correspondence 
between real and virtual are referred to as 
dedicated devices. Tape devices are always 
dedicated. The user can dedicate disks, 
terminals, and unit record devices to a 
virtual machine to improve the performance 
of that virtual machine. The 3800 
high-speed printer is also supported as a 
dedicated device. 
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^ass Storage System 



Virtual I/O Devices 



The virtual machine supports the same 
devices as a real machine: It is the 
virtual machine, not VM/370, that controls 
them- The I/O configuration must be 
defined by the user in the VM/370 directory 
entries. However, additional I/O 
requirements can be met dynamically by the 
user via CP commands. 

The user also has the option of 
assigning different address to his virtual 
devices, or using those of the real 
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With HSS, there are available to the 
host processor as many as 192 DASD device 
addresses per DASD control unit. Dp to 192 
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HSS volumes per control unit may be mounted 
and online at any given time. Each of 
these volumes may be accessed by a virtual 
machine for the same purposes that a real 
3330-1 is used. Any virtual machine may 
have access to all or part of an MSS volume 
just as though it were a real 3330-1, with 
one exception: the VM/370 control program 
may not use MSS volumes for system 
residence, paging, or spooling. 



The minidisk owner can ensure the 
security of his disk by specifying a 
password option to his read/write disk or 
he can limit disk access to read-only. To 
avoid updating conflicts, VM/370 gives 
write access of a shared disk to one 
virtual machine at a time. However, the 
user can specifically request multiple 
access, if he so chooses. 



When one or more of the MSCs channel 
ports is attached to the VM/370 system, the 
volume REALID in Figure 3 can be a MSS 
3330V volume- The volume REALID will be 
dynamically mounted by the system whenever 
minidisk MINI01, MINI02, or MINI03 is 
required by a virtual machine. 



VIRTUAL DISKS 



VIHTDAL OBIT RECORD DEVICES 
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MINI01 



MINI02 



MINI03 



126 



Note: Each minidisk starts at 
virtual cylinder zero. 



Real 

Cylinder 

Numbers 



202 



Figure 3. Real Disk Containing Minidisks 



VIBTOAL TRANSMISSION CONTROL UNITS (VIRTUAL 
LINES) 



A virtual machine configuration can include 
a virtual transmission control unit (TCO) . 
One real TCU can be used to simulate 
multiple virtual TCUs. 

A real TCO cannot be shared by 
concurrently operating virtual machines. 
However, by defining virtual transmission 
control units, a real TCU can be 
concurrently shared by several virtual 
machines. 



VIRTUAL CBANNEL-TO-CHANNEL ADAPTER 



The user can define a virtual 
channel-to-channel adapter (CTCA) with or 
without a real equivalent. If a real 
channel-te-channel adapter is dedicated to 
a virtual machine, that virtual machine can 
communicate with a real computing system 
other than its own real system. However, 
if it does not exist, a virtual machine can 
only communicate with virtual machines in 
the same computing system. 
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An alternative to a virtual 
channel-to-channel adapter is the virtual 
machine communication facility (VHCF) which 
is descrited iriefly in this section under 
the topic "Other System Features." 



VI\/l/370 Directory 



LOGON PROCEDDBE 



To logon to VM/370, a user enters (via a 
keytoard terminal device that is connected 
to the VM/370 system) a valid userid and a 
password. This and other information in 
the user's directory enables VB/370 to 
create a virtual machine that is tailored 
to the individual user. 



The VM/370 directory is a file containing 
entries for all potential virtual machines. 
These entries contain control statements 
that define each virtual machine and its' 
configuration. It contains the user 
identification and password, as well as the 
CP command privilege class assigned to the 
user. 

Other optional information can be 
included such as performance and operating 
parameters. 



DSER VIRTI VIRTI 512K 1M G 

ACCOUNT S5 SYSPRG 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 

SPOOL ODD 2540 PDNCH A 

SPOOL OOE 1403 A 

MDISK 191 3330 001 001 CPR6L1 R 

LINK MAINT 194 194 RR 

Figure 4. Sample Directory Entry 



Figure 5 illustrates a logon procedure 
for user "DSERl". The user enters the 
userid. The system responds and then waits 
for the password to be entered. (For 
security purposes this password is masked.) 
CP verifies the userid and password. The 
user is then notified by a CP response that 
he is logged on. After successfully 
logging on the system, the user may load 
any supported operating system and proceed. 



vm/370 online | 

logon DSEHI I 

ENTER PASSWORD: | 

I 
LOGON AT 11:03:18 ON WEDNESDAY 11/29/78 | 



ipl cms 



Figure 5. Logging onto VM/370 and Loading 
CMS 
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The LINK statement indicates this 
virtual machine has a read-only access to a 
minidisk defined to another virtual 
machine. One permanent 3330-series 
minidisk is also defined. 

When a user gains access to the VM/370 
system, a virtual machine is created based 
on the information in the user's directory 
entry. 



The security journaling option, specified 
during system generation, dees not allow 
passwords for the LOGCH/ADTCLOG and LINK 
commands to be entered on the same line as 
the command. 

If the security journaling option is 
specified, and the logon attempt is 
unsuccessful, these attempts are recorded 
and the system administrator is notified 
via messages. 



Virtual Machine Operating Systems 
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SDPPORTED OPERATING SYSTEMS 



Multi£le-access systems 



Figure 6 lists the operating systems that 
can execute in virtual machines. 



Batch or Single— User Interactive 
DOS 

DOS/VSE 
OS/PCP 
OS/MFT 
OS/MVT 
OS/V^I 
0S/VS2 
OS-ASP 
RSCS 

Multiple- Access 
VM/37 
Time Sharing Option of OS 

Conversational 

CMS 



Multiple-access systems, such as VB/370, 
execute in one virtual machine and directly 
service many interactive terminals. To 
connect a terminal with the virtual 
machine, the user of a multiple-access 
system issues the DIAL command instead of 
the LOGON command. 

Once his terminal is connected, the user 
issues only the commands associated with 
the multiple-access system. For example, 
the DIAL command connects the user's 
terminal with a VM/370 system executing in 
a virtual machine under VM/370. Once his 
terminal is connected, the user 
communicates only with that particular 
version of VM/370. 

Note: When using the DIAL command, the user 
may not log onto CP. Therefore, the CP 
commands cannot be used unless the system 
legged onto is a virtual VM/370. 



Figure 6. 
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For information about ether programs and 
systems that have been used under VM/370, 
request information on Installed Oser 
Programs (IDPs) and Field Developed 
Programs (FDPs) from your local IBM branch 
office. 



VM/370 Applications 



Dsing VM/370, an installation can perform 
its work more efficiently and easily. 
Virtual machine applications aid in 
programming, operations, and interactive 
use. 



Single-user systems 



SYSTEM PROGRAMMING 
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An interactive virtual machine environment 
provides these advantages for system 
programming: 

• Reducing the amount of hands-on testing 
time en the real machine — thereby 
reducing the requirements for off-shift 
testing 

• Testing new or modified SVC routines in 
a virtual machine 

• Applying and testing PTFs en a virtual 
machine 
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Generating and testing in a virtual 
machine either new independent component 
releases (ICRs) or new releases of an 
operating system 

Debugging from a hands-on console (a 
terminal device) as though on a 
dedicated real machine 



APPLICATION PBOGRAHMISG 



An interactive virtual sachiue eiivii-onmeut 
provides these advantages for application 
programming: 

• Using the CMS editor to create source 
programs and data files 

• Osing the CMS UPDATE command and the CMS 
editor to maintain source programs and 
data files 



Debugging from a terminal while under 
operating system control 

Providing faster turnaround time, more 
test periods per day, and a shorter 
development cycle 

Designing application programs without 
real storage limitations 

Defining minidisks and ether virtual 
devices to design and test a slightly 
different or larger machine 
configuration before installing the 
hardware 

Using SCEIPT/370- an Installed User 
Program (IDP) for text preparation, to 
create and update program specifications 
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Figure 7. Virtual Machines Running Concurrent Production, Development, and Testing 
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OPERATIONS 



Performance Options 



An interactive virtual machine environment 
relieves problems of scheduling, support, 
and backup and expedites production. Some 
of these operational advantages are: 

• Training operators in a virtual machine 
that is isolated from production virtual 
machines 

• Providing a shorter training period 



Defining a 
devices as 
machine 



virtual machine and its 
backup to another real 



• Running different types of work 
concurrently on a single real machine 

• Reducing the manual handling and 
scheduling of user test periods by the 
operations staff — users run their own 
virtual machines 

• Executing many types of batch 
applications with no change to the 
program either in an individual virtual 
machine or in a virtual machine 
dedicated to executing programs in batch 
mode. 

a possible combination of virtual 
machines in a VM/370 configuration is shown 
in Figure 7. Operating system testing is 
done concurrently with batch work and a 
variety of conversational applications. 



Backup System 



An installation 
flexibility in 
computing system 
same System/370 
of real storage 
backup system. 



using VM/370 has more 
using another System/370 

for backup. Neither the 
model nor the same amount 

have to be part of the 



The backup system must include, but is 
not limited to, the same type and number of 
real devices as these virtual machines 
require. Also, the backup system must have 
a sufficient number of direct access 
storage drives so that the user volumes can 
be mounted. 

Because the virtual devices defined for 
the virtual machines are not assigned to 
specific real devices until execution time, 
the installation need not be concerned with 
device addresses. 



The performance of any computing system is 
judged by how efficiently it processes the 
work it has to do. 

VM/370 offers the following performance 
options to enhance the operating efficiency 
of one or more virtual machines. The 
performance options are: 

Virtual machine assist 

VM/370 Extended Control-Program support 

Locked pages 

Reserved page frames 

Virtual=real 

Favored execution 

Priority 

attached 



Affinity in an 
environment 



processor 



For detailed information concerning 
these performance options, refer to VH/370 
O^erator^s Guide and Vb2370 Plannina and 
System Generation G uide . 



VIRTUAL MACHINE ASSIST 



When an operating system is run in a 
virtual machine under VM/370 it is 
dispatched by CP in the problem state. All 
privileged instructions issued by the 
operating system cause program interrupts 
and CP must simulate the desired effect of 
the operation. The virtual machine assist 
feature performs many of the privileged 
instruction simulation functions without 
the virtual machine leaving the problem 
state. The result is a considerable 
reduction in overhead. Virtual machine 
assist may be considered a prerequisite to 
running production jobs under an operating 
system in a virtual machine. 

The system operator enables or disables 
t>€" virtual machine assist via a command. 
However, if the function has been enabled 
for the system, the user has the choice of 
setting it off for his machine, and later 
setting it on again. 
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VH/370 EXTENDED CONTOL-PROGRAM SUPPORT 



FAVORED EXECDTIOK 



Control-Program support is 
assist function that is 

certain VH/370 supported 
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VH/370 Extended 
a hardware 
available on 
processors. Thi 
when used with 
function, furth 
to support vir 
improved perfor 



LOCKED PAGES 



The system operator can, by use of a 
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into real storage. This is done to 
eliminate paging activity on these pages, 
thus reducing virtual storage. 



The favored execution option provides a 
particular virtual machine an assured 
percentaqe of real processor time. 



AFEINITY 



Under the normal attached processor, either 
processor can handle the virtual machine 
execution. However, with the affinity 
capability, only the specified processor 
will allow virtual machine execution. 



PERFORMANCE MEASUREMENT AND ANALYSIS 



RESERVED PAGE FRAMES 



A more flexible approach than locked pages 
is reserved page frames. The system 
operator assigns a certain number of page 
frames to a specified virtual machine. The 
pages are not locked into these page 
frames. Pages can be paged out, but only 
for other active pages of the same virtual 
machine. 



VIRTUAL^REAL 



The virtual=real option can be assigned 
during system generation. With this 
option, a virtual=real area is allocated 
directly from storage when VM/370 is 
initially loaded, and that area remains 
allocated unless it is released by the 
system operator. 

The virtual=real option improves 
performance in the selected virtual machine 
because CP no longer has to perform paging 
operations. 



PRIORITY OPTION 



The priority option affects 
of a particular virtual mach 
with other virtual machines 
same characteristics. A 
assigned to a virtual machi 
combination with other 
influence the dispatching a 
lower the value, the greater 
of processor time given 
machine. 
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The VM/370 control program has two commands 
that cause CP to collect and display 
performance related data. 

The MONITOR command gathers data 
relating to most aspects of system 
performance and writes the data on tape or 
spool file. When the data is reduced, it 
may indicate the conditions contributing to 
performance degradation. 

The INDICATE command displays, at the 
terminal, some key information about the 
show the current performance 
INDICATE displays the system 
existing at the time it is 



system to 
conditions 
conditions 
issued. 



Error Recording and Anaiysis 



Operating systems that commonly run in 
virtual machines write error records to the 
error recording data sets. However, in a 
virtual machine CP intercepts the error, 
and VM/370 records the error in its own 
error recording cylinders. Therefore, 
error records from all operating systems 
reside in this one centralized error 
recording area. 



Other System Features 



Besides error recovery and CP command 
features, VM/370 contains several other 
features that expand the capabilities of 
operating systems running in virtual 
machines. They are: 

• Virtual machine accounting 

• Saved systems 

• Shared systems 



Introduction 



Discontiguous saved segments 

Shared segment protection 

Virtual machine communication facility 



VIRTUAL MACHINE ACCOUNTING 



VM/370 keeps track of a virtual machine's 
usage of system facilities and punches 
accounting cards whenever the use of some 
chargeable resource is terminated. For 
operating systems that do not have job 
accounting, this would be one way of having 
VM/370 gather job accounting data. 

When accounting data records are 
generated, CP stores them in real storage. 
These records remain there until they are 
punched on the real punch. 



SAVED SYSTEMS 



When initially loading an operating system 
into a virtual machine by device address, 
VM/370 reads the resident nucleus into real 
storage and writes it back out to the 
system paging device. Simultaneously it 
updates the virtual machine's paging 
tables. 

To save the results of an IPL at a 
predetermined point (by the type of 
operating system) , VM/370 allows an 
installation to assign this saved system a 
name. 

Note: Saved systems cannot be loaded into 
the virtual=real area of VM/370. An 
attempt to do so results in an error 
message. 



SHARED SYSTEMS 



A saved system can also share reentrant 
portions of its virtual storage among many 
concurrently operating virtual machines. 

In a uniprocessor environment, 
regardless of the number of virtual 
machines using the shared segments, only 
one copy of the pages in the shared segment 
need ever occupy real storage and external 
page storage. In an attached processor 
environment, there will be one copy of the 
page{s) in the shared segment per 
processor. This reduces the total real 
storage and auxiliary storage reguired. 



The greater the number of virtual 
machines that are using a shared system, 
the greater the storage savings, and the 
greater the probability that the shared 
page(s) will be frequently referenced. 
Frequently referenced pages tend to remain 
in real storage, thereby reducing paging 
activity. Less paging activity increases 
the efficiency of the processor. 



DISCONTIGUOUS SAVED SEGMENTS 



to saved systems, 
named, loaded, and 
a system; they must 



Discontiguous saved segments (DCSS) are 

similar in many ways 

DCSS must have been 

saved as when saving 

also be loaded at an address higher than 

the highest address of the virtual machine 

using it. 

DCSS can be logically attached by a 
virtual machine whenever needed and 
detached when not needed. The CP 
instructions required to perform the 
linkage must be part of the virtual 
machine's operating system. 

Note: Systems using DCSS cannot be loaded 
into the virtual=real area of VM/370. An 
attempt to do so results in an error 
message. 



SHARED SEGMENT PROTECTION 



The mode of shared segment protection may 
be specified at system generation time. 



With 
protect 
segment 
inadver 
segment 
a new 
whether 
has alt 
If so, 
console 
page to 
copy of 
shared 



shared 
s the 
s fr 
tent 
's code 
user t 
or not 
ered a 
CP pi 
f uncti 
free s 
the s 
system 



segment 
multiple 
om any 
alteration 

or data, 
o be dis 
the curr 
ny pages i 
aces the 
on mode, 
torage, a 
bared page 
users. 



protection, VM/370 

users of shared 

intentional or 

of the shared 

Before CP selects 

patched, it checks 

ent virtual machine 

n shared segments. 

virtual machine in 

returns the altered 

nd prepares a fresh 

for the remaining 



Without shared segment protection 
specified for a named system, changes made 
by a user to pages in shared segments of 
the system remain undetected by the VM/370 
control program. All users of the 
unprotected shared segment will see the 
change. 
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Installaticns choosing to run with VIETDAL MACHINE COMMDNICfiTICN FACILITY 
unprotected shared segments should 
carefully evaluate these segments to ensure 

that they contain read-only information. The virtual machine communication facility 

The unprotected option for shared segments (VBCF) allows one virtual machine to 

will eliminate the overhead involved in communicate and exchange data with other 

scanning for changed pages in both virtual machines operating under the same 

uniprocessor and attached processor VM/370 system. A more detailed description 

systems, in switching page table pointers, of VMCF can be found in the "Control 

and in maintaining duplicate copies of Program" section of this publication, 
shared systems in an attached processor 
environment. 
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Control Program 



CP (the control program of VM/370) creates 
and controls virtual machines. A virtual 
machine is the functional equivalent of a 
real computing system. Executing a program 
in a virtual machine produces exactly the 
same output as executing that program on a 
real machine. 

When a user logs on VM/370, CP creates a 
virtual machine for him. Based on 
information stored in the VM/370 directory, 
CP creates s virtual machins with specific 
amounts of virtual storage and virtual 
devices. The command privilege classes 
allowed for the virtual machine and 
optional support (such as, extended control 
mode) are also determined by each virtual 
machine's entry in the VM/370 directory. 



CP allows a virtual machine to gain 
access to the real processor only if the 
virtual machine is not waiting for some 
resource or activity, such as: 

• A page of storage to be loaded from 
auxiliary storage into real storage 



An input/output operation to 
translated, begun, or completed 



be 



> f-T> ^^T^^ri-^ r* •»-.-> -F 



.^ V'UUIUIClllU 



uO j.j.uXSu execuuxng 



CP controls 
computer to 
machines. CP 
schedules all 
operations of 



the resources of the real 
provide multiple virtual 
intercepts, translates, and 
of the real input/output 
the virtual machine. All 
virtual machines execute in problem state, 
and the control program traps and processes 
interrupts and privileged instructions. 
Only CP executes in supervisor state. 



Virtual Machine Storage 
Management 

Each virtual machine has storage associated 
with it; the amount of storage is defined 
in the VM/370 directory. Each virtual 
machine functions as if it has a large 
amount of real storage. However, each 
virtual machine's storage is created and 
controlled by C? as virtual storage. The 
virtual machine's storage can be larger or 
smaller than the storage of the real 
machine. 



The directory entry contains two sizes 

for each virtual machine: its normal size 

Virtual Machine Time Management and a maximum size. The normal size must 

be at least 8K (8192) bytes 



Although virtual machines appear to their 

users to be executing instructions, it is 

the real processor that is actually doing 
the work. 

VM/370 uses a technique called time 
slicing so that one real processor appears 
to be multiple virtual processors. Each 
virtual machine periodically gains access 
to the real processor for a small amount of 
time, called a time slice. CP determines 
how frequently and for how much time a 
virtual machine gains access to the real 
processor by examining the number of 
console requests, or terminal interrupts, 
the virtual machine has issued during its 
past time slices. If the number is large, 
CP defines the virtual machine as a 
conversational user and assigns it the 
smaller of two possible time slices. If 
the number is small, the virtual machine is 
a nonconversational user and is assigned 
the larger time slice. CP gives 
conversational users more frequent access 
to the real processor for short time 
slices, while it gives nonconversational 
users larger time slices at less frequent 
intervals. 



The maximum 
size must be no larger than 16 megabytes. 
Both sizes must be multiples of 4K (4096) . 
When a user logs on, his virtual machine 
storage size is the amount of storage 
defined as the normal size. However, the 
user can temporarily redefine his virtual 
storage size to any value that is a 
multiple of ilK (iJ096) and not greater than 
his virtual machine's maximum size. 

Storage in the virtual machine is 
logically divided into 64K (65,536) byte 
areas called segments. These are further 
divided into 4K byte areas called pages. 
For each virtual machine, CP creates and 
updates a set of segment and page tables to 
describe the virtual storage and to reflect 
the allocation of the virtual storage pages 
to page frames in real storage. These 
tables are used by the Dynamic Address 
Translation feature during virtual machine 
execution to locate the real storage 
addresses to which the virtual storage 
addresses actually refer. 
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OPERATING SYSTEM 
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0S/VS1 creates and controls a single 
virtual storage. It creates and updates a 
set of page and segment tables that relate 
this virtual storage to the virtual storage 
of the virtual machine. In VM/370, "first 
level storage" refers to real storage, 
"second level storage" refers to virtual 
machine storage, and "third level storage" 
refers to the virtual storage created and 
controlled by the virtual machine. When 
0S/VS1 is executing, instructions and data 
from third level storage must be available 
to the processor. Thus the real machine 
cannot use the page tables created by 
0S/VS1 nor the page tables created by CP. 
The real machine must have a set of page 
and segment tables that relate third level 
storage to first level storage. CP 
dynamically constructs and updates such 
tables, called shadow tables. CP has a 
single set of shadow page tables for any 
one virtual machine. A single set is all 
that is necessary for 0S/VS1, 0S/VS2, or 
EOS/VS. 

However, when VM/370 itself is used as a 
virtual machine operating system, it can 
create multiple virtual machines, each with 
its own virtual storage. In this case, the 
shadow tables are invalidated by CP 
whenever it passes control from one virtual 
machine to another. 



SEGMENTS 



specified at system generation. For a 
protected shared segment, if a user 
attempts to alter a page in a shared 
segment the user receives a message 
informing him of an integrity violation and 
his virtual machine is placed in console 
function mode. For both protected and 
unprotected shared segments: Whenever a 
user issues a command that alters a shared 
segment, the user is unshared from the 
shared segment and given a private copy of 
the segment including the altered page. 

Noncontiguous segments can be attached 
to and detached from virtual machines. 
They can be shared or nonshared. 
Noncontiguous segments may be within the 
virtual machine's defined storage, appended 
to the end of its virtual storage, or 
loaded at addresses beyond its virtual 
storage. VM/370 supports noncontiguous 
segments for CMS; in this case, the 
addresses of the noncontiguous segments 
must be greater than the highest address in 
the virtual machine that is attaching them. 
For a description of shared segments, 
noncontiguous segments, and named systems 
see the VM/370 System Programmer's Guide. 



PAGING 



The storage of the real System/370 is 
physically and logically divided into 4K 
byte areas called page frames. When a page 
of virtual storage is brought into real 
storage, it fits exactly into a page frame. 

Paging is done on demand by CP. This 
means that a page of virtual storage is not 
read (paged) from the paging device to a 
real storage page frame until it is 
actually needed for virtual machine 
execution. Paging operations are initiated 
and performed by CP and reguire no action 
by the virtual machine. 

The heavily used portions of VM/370 are 
kept in real storage. However, to optimize 
real storage usage only virtual storage 
pages that are referred to frequently are 
kept in real storage. A page can be 
brought into any available page frame 
during CP program execution. 



One or more segments of virtual storage can Inactive pages are stored on a direct 

be shared among virtual machines. The access storage device. If an inactive page 

information to be shared must be read-only; is changed at some time during virtual 

it may be data or reenterable program machine execution, CP assigns it to a 

modules. The information to be shared must paging device, selecting the fastest one 

be part of a monitor or operating system with available space. If the page is net 

(for example, CMS) that has been recorded changed, it remains allocated in its 

or saved on a CP-owned volume. original direct access locations and is 

paged into real storage from there the next 

I The protected or unprotected status of a time the virtual machine refers to that 

I system containing shared segients is page- 
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Virtual Machine I/O Management 
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When OS sxscutss in a real machine 
input/output operations are initiated when 
a problem program requests OS to issue a 
Start I/O instruction to a specific device. 
Device error recovery is handled by the 
operating system. In a virtual machine, OS 
can perform these same functions, but the 
device address specified and the storage 
locations referred to are virtual. CP 
translates the virtual addresses to real 
addresses. 

Because the virtual machine executes 
only in virtual (not real) supervisor 
state, CP gains control when the Start I/O 
instruction is issued by the virtual 
machine operating system. CP copies into 
its own work area the channel command list 
specified by the operating system, and 
pages into real storage all virtual storage 
locations required for data transfer. The 
specified pages are fixed in real storage 
until the input/output operation completes. 
If a single channel command word specifies 
a data area extending over multiple pages 
of contiguous virtual storage, CP generates 
channel programs that use channel indirect 
data addressing to handle noncontiguous 
page frames. If the virtual device is a 
minidisk, CP modifies any cylinder numbers 
specified to reflect the true location of 
the data. CP assigns the virtual device 
address to the real device and schedules an 
actual input/output operation. 

When an I/O device is a Mass Storage 
System (HSS) 3330V, but the virtual device 
is defined as a 3330-1, CP places a prefix 
on the actual channel program. This prefix 
allows CP to determine when an MSS cylinder 
fault occurs and queue the I/O operation 
until the cylinder fault is corrected. 
This operation is transparent to the 
virtual machine. However, if the virtual 
device is defined as a 3330V, no prefix is 
added to the channel program and cylinder 
faults must be processed by the virtual 
machine. 

During this processing, CP designates 
the virtual machine as not executable. When 



the virtual machine gains control, CP gives 
it a suitable condition code (as on a real 
machine) to indicate the status of the 
Start I/C operation. In addition, CP 
reflects the interrupts caused by the 
input/output operation for its 
interpretation and processing. 

Interrupts indicating that an BSS 
cylinder fault has occurred, and that a 
cylinder fault has been resolved, are 
passed to the virtual machine only if the 
virtual device is defined as a 3330V. 

If input/output errors occur, CP does 
not initiate error recovery operations; 
these are the responsibility cf the virtual 
saCuine operai^xng sysi.es. uasxc error 
recording is, however, provided by CP. For 
more information on error processing, see 
the VM/370 CLTSEP and Error Recording 
Guide. 

The programs to be executed in a virtual 
machine (except a virtual=real machine) 
generally must not include dynamically 
modified channel programs. These and other 
restrictions that apply to virtual machines 
are discussed in the VB/370 Planning and 
System Generation Guide. 



VIBTDiL DISKS 



Virtual disks, often called minidisks, can 
be shared by several virtual machines. 
Virtual disk sharing is specified in the 
VH/370 directory entry or by a user 
command. If the user issues the CP LIHK 
command to share a virtual disk, he must 
supply the appropriate password before he 
can gain access to the virtual device. 

1 particular virtual machine may be 
assigned read-only or read/write access to 
a shared virtual disk. CP checks each 
virtual machine input/output operation 
against the specifications in the virtual 
machine configuration to ensure device 
integrity. 

Virtual disks may be defined for 
temporary use by a virtual machine. In 
that case, CP allocates real disk storage 
to the virtual machine until the virtual 
machine logs off or specifically detaches 
the temporary virtual disk. 



CHANNEL 



a virtual machine may be assigned a 
dedicated channel, via the ATTACH CHANHIL 
command. If a virtual machine is assigned 
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a dedicated channel, it has that channel 
and all of its devices for its exclusive 
use. CP translates the virtual storage 
locations specified in channel coiaands to 
real locations and performs any necessary 
paging operations, but does not need to 
translate any device addresses. The 
virtual devices on a dedicated channel must 
have direct, real equivalents (for example, 
■inidisks are not allowed) , and the virtual 
and real device addresses must be 
identical. A channel dedicated to a 
virtual machine cannot be used by any other 
virtual machine. Virtual machines may have 
a mixture of dedicated and nondedicated 
channels. 



environment, and uses this interface 
instead of the normal Start I/O instruction 
for most of its input/output operations. 
When the Diagnose interface is used, CP 
handles input/output error recovery 
operations. 

Input/output operations initiated by CP 
for its own purposes, for example, paging 
and spooling, are performed directly and 
are not subject to the translation process 
described in the preceding paragraphs. 

For a description of how virtual 
machines running under the same VH/370 
system can communicate and exchange data, 
see "Virtual Machine Communication 
Facility" in this section. 



VIRTDAL MACHINE CHASHEL MODE SELECTION 



Virtual machine SIO (Start I/O) operations 
are simulated by CP in three channel modes: 
byte multiplexer, selector, and block 
multiplexer. 

Virtual byte multiplexer channel mode is 
reserved for I/O operations for devices 
allocated to channel zero. 

Selector channel mode, the default mode, 
is the mode of operation for any channel 
that has an attached channel-to-channel 
adapter (CTCA) , regardless of the selected 
channel mode setting. Because the CTCA is 
treated as a shared control unit, it must 
be connected to a selector channel. 

Block multiplexer channel mode allows 
the virtual machine's operating system to 
overlap SIO requests to multiple devices 
connected to the same channel. For a 
virtual machine in block multiplexer mode, 
CP simulates a real block multiplexer 
operation. 

Note; CP simulation of block multiplexing 
does not reflect channel available 
interrupts to the user's virtual machine. 

The selection of block multiplexer 
channel mode or selector channel mode is 
effective regardless of the real channel 
devices on the System/370. The channel 
operating mode is selected via the CP 
DEFINE command in the VM/370 directory 
entry for a virtual machine. 



DIAGNOSE INTERFACE 



A virtual input/output operation by CP can 
be simplified if the virtual machine uses 
the DIAGNOSE interface. CMS was designed 
specifically for the virtual machine 



Spooling Unit Record I/O 



CP spooling facilities allow multiple 
virtual machines to share real unit record 
devices. Since virtual machines controlled 
by CMS ordinarily have lew requirements for 
unit record input/output, real device 
sharing is advantageous, and is the 
standard mode of system operation. 
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INPOT SPOOL FILES 



Input spool files, that is, data available 
at a virtual card reader, can be created 
from real card decks. The real machine 
operator places the card deck in the input 
hopper of the real card reader. The real 
card deck must be preceded by a DSERID card 
that names the virtual machines to receive 
the card deck. 
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OUTPUT SPOOL FILES 
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Remote Spooling 



Output spool files are created on direct 
access storage when the virtual machine 
operating system writes to a virtual punch 
or printer. Real output is scheduled for a 
real printer or punch, or for remote 
output, whenever a user logs off the system 
or issues a CP CLOSE command. 



ADDING AND TRANSFERRING FILES 



If the direct access storage space assigned 
to spooling becomes full, spooling stops 
and the virtual unit record devices appear 
to be not ready. The spooling operator 
must make additional spooling space 
available. He can purge existing spool 
files or assign additional direct access 
storage space for spool files. 



Specific files ca 
the spooled card pu 
virtual machine to t 
same or another v 
virtual card reader 
80-character records 
between virtual unit 
spooling routines 
punched or printed 
support can make 
multiple virtual mach 
operating systems ex 
times in the same vir 



n be transferred from 

nch or printer of a 

he card reader of the 

irtual machine. (A 

is not limited to 

.) Files transferred 

record devices by the 

are not physically 

The CP spooling 

files available to 

ines, or to different 

ecuting at different 

tual machine. 



CP can print multiple copies of a single 
spool file, backspace any number of printer 
pages, and define spooling classes for real 
output files. 



Spooling Virtual Console I/O 



CP, in conjunction with ESCS, supports 
remote spooling, that is, RSCS transmits 
j-ixes across a teleprocessing network. The 
"Remote Spooling Communications Subsystem" 
section describes RSCS and how it is used. 



CP Commands 



CP commands are used interactively by 
operators and systems personnel to control 
the real computing system and VM/370, and 
by users to control virtual machines and 
their operating systems. 
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Privilege Classes 



Each user of VM/370 is assigned one or more 
privilege classes as part of the directory 
entry of his virtual machine. The 
privilege classes define the subset of CP 
commands that each user can execute. See 
Figure 8 for a concise description of each 
privilege class. 



CP allows the user to spool his virtual 
machine's console input/output on disk, 
instead of, or in addition to, having it 
displayed at his terminal. The data 
spooled includes messages from or to the 
virtual machine operating system, CP 
commands entered by the user, CP messages 
and responses, and messages from or to the 
system operator. Console spooling is 
invoked by the SPOOL CONSOLE command. It 
is particularly useful when the virtual 
machine is executing with the terminal 
disconnected, because the virtual console 
output, which would othierwise be lost, is 
saved on disk. The saved data is later 
printed on the real printer. When a 
console spool file is closed, it becomes a 
printer spool file. 



GENERAL USERS 



A general user can issue commands that 

control functions associated with the 
execution of his virtual machine. 

A complete list of the general user 

commands and their descriptions, are 
located in the IMZ370 CP Command Reference 
for General Users. 
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Class 



fti 



Bi 



Ci 



Di 



El 



Fi 



G2 



Any2 



User 



Function 



Primary System Operator | To be responsible for the avail- 
Note: The class A user | ability of the VM/370 system, its 
who is logged on at CP | communication lines, and resources, 
initialization is | In addition, the class A user 
designated as the | controls system accounting, broad- 
primary system operator. | cast messages, virtual machine per- 

1 formance options and all other 
1 commands that affect the overall 
1 performance of VM/370. 


System Resource Operator | To control all the VM/370 real 

1 resources, except those controlled 
1 by the class A or class D user. 


System Programmer | To update certain functions not 

1 controlled by other privileged 
1 class users. 


Spooling Operator | To control all spooling data and 

1 specific functions of the unit 
1 record, devices. 


System Analyst | To examine and save specific data 

1 in the VM/370 storage area. 


Service Representative | To obtain and examine, in detail, 

1 certain data concerning the I/O 
1 devices connected to the VM/370 
1 system. 


General User | Control functions associated with 

I the execution of the users virtual 
1 machine. 


Any User | Gain and relinguish access to the 

1 VM/370 system. 


Reserved | Reserved for IBM use only. 



1 Described in the YB / 370 Op erator's Guide 

^Described in the VM/370 CP Command Reference for General Users 

I ' 

Figure 8. CP Privilege Class Descriptions 



OTHER USERS 



Users, other than the general user, can 
perform additional functions by issuing 
commands to dynamically provide VM/370 
performance options, to terminate a 
particular virtual machine and many other 
similar functions. 



VM/370 Attached Processor 
Support 

On systems that are either an attached 
processor complex or an asymmetric 
multiprocessor complex, VM/370 has a mode 
of operation that takes advantage of the 
additional computing power that such 



systems provide. This mode of operation is 
called attached processor mode. In this 
mode, two instruction processors 
simultaneously execute multiple tasks from 
a common gueue while sharing the same main 
storage. 
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system may still be able to perform in 
uniprocessor mode. It does this by 
dynamically switching the channel set (all 
active channels of the main processor) to 
the other processor, thereby, utilizing the 
attached processor as the main processor. 

This flexibility of system operation, 
along with CP's VARY ON/OFF PROCESSOR 
command, facilitates system reliability. 



availability and serviceability (RAS) . RAS 
is enhanced because main components of a 
system complex can be placed offline for 
system repair or upgrade at a time that 
minimally impacts system operations. 
Later, when the full resources of the 
system are needed and available, the 
processor can be varied online and attached 
processor mode reestablished. 
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18.2 IBM VM/370 Introduction 



Virtual Machine Communication 
Facility 

The virtual machine comniunicaticn facility 
(VHCF) allows one virtual machine to 
conmunicate and exchange data with any 
other virtual machine operating under the 
same VM/370 system. 

This is accomplished via a DIAGNOSE 
instruction utilizing a special parameter 
list. VMCF locks one data page for the 
sender and one for the receiver during the 
transfer. is a result, data transfer is 
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directly from the sender's virtual storage 
to the receiver's virtual storage- The 
transfer does not involve devices because 
VMCF uses userids to logically address data 
from one virtual machine to other virtual 
machines. 

A virtual machine can have one to 50 
active communications going on with other 
virtual machines. The amount of data that 
can be transferred in a single operation is 
limited only by the virtual storage size of 
the virtual machines involved in the 
transaction. 

A more detailed description of VMCF 
functions and how they can be invoked in a 
virtual machine is contained in the VM/370 
System Programmer's Guide. 



VM/VS Handshaking 



VM/VS handshaking is a communication path 
between the control program (CP) component 
of Vfi/370 and the following operating 



systems running as virtual machines under 
VH/370: 

• COS/VS Release 34 Advanced Functions — 
DOS/VS program product (program number 
5746-X12) 

• VS1 Release 4 and subsequent releases 

To improve their operation with VB/370, 
the operating system and CF make each other 
aware of mutual capabilities or 
requirements. Systems generated to use 
VH/VS handshaking may have the dual ability 
to run both in a real machine and in a 
virtual machine. Virtual machine systems 
that have VH/VS handshaking can more 
realistically simulate the operation of 
their real machine. 

VH/VS handshaking consists of: 

• Closing CP spool files when job output 
is complete. This allows VM/370 to 
immediately process these output files 
without operator intervention. 

• Processing pseudo page faults. When the 
pseudo page fault handling portion of 
handshaking is active, one task can be 
dispatched while another is waiting for 
a page to be brought into real storage. 

• Providing a non-paging mode to eliminate 
duplicate paging. 

• Providing a way to avoid a FCI 
(program-controlled interruption) in a 
ETAH autopoll CCW loop. 



Providing miscellaneous 
when running under VM/370, 



enhancements 
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Conversational Monitor System 



The conversational monitor system (CMS) is 
a major component of VH/370. Together with 
the control program of VM/370, it provides 
a time-sharing system suitable for direct 
problem solving and program development. 
CMS is an operating system that executes 
only in a VM/370 virtual machine. (CHS 
uses the Diagnose interface for all of its 
disk and tape input/output operations and 
has no error recovery routines.) 

The user can create, update, and 
manipulate files as well as complete, test, 
and execute problem programs. These 
interactive capabilities are extended to 
DOS/VS users via the CMS/DOS environment or 
CMS. For OS/VS users, a combination of CMS 
commands and CMS simulation of OS macros 
provides similar interactive capabilities. 



CMS Configuration 



A virtual machine that is to use CMS is 
configured much the sane way as any other 
virtual machine, with a few special 
considerations. 



cannot be dedicated to the CMS machine 
because CMS has no unit record error 
recovery procedures. 

CMS supports tape devices, but disk 
volumes are the primary external storage 
for CMS command processing. 

Generally, each CMS user is assigned at 
least two disks: a read-only system disk 
and a read-^write user disk^ 

The read-only system disk contains the 
CMS nucleus, disk-resident CMS commands, 
and the system library. The CMS system 
disk can be shared among CMS users. 



The read/write disk contains the user's 
permanent and temporary files. The size of 
a CMS user disk is limited to one volume or 
the maximum number of CMS records that can 
be contained on one volume. CMS disks must 
be assigned in units of full cylinders. 

Figure 9 shows a virtual machine 
configured to execute CMS. A minimum CMS 
configuration would not include the virtual 
tapes. 



The CMS virtual machine must be assigned 
at least 320K bytes of virtual storage, of 
which 128K is used by the CMS nucleus. 
User programs that execute in CMS may 
increase this requirement. The virtual 
storage size may be defined as large as 16 
megabytes, in multiples of 4K. 

The most active portion of the nucleus 
can be shared by users of CMS via the 
shared segment facilities of VM/370. The 
amount shared is 64K, one full segment. 
This allocation is not locked in real 
storage, which means that a particular 
shared page may not be in real storage at 
any given time. However, the most active 
pages tend to remain in real storage. 

Additional portions of CMS can be shared 
in discontiguous segments. Discontiguous 
segments can be attached to and detached 
from the CMS virtual machine as needed. A 
name is associated with one or more 
discontiguous segments. Some, all, or none 
of the discontiguous segments can be 
shared. Discontiguous segments must be 
loaded at addresses beyond the highest 
address in the virtual machine. 

CMS supports unit record devices only if 
they are virtual and use the CP spooling 
facilities. Real unit record devices 



CMS File System 



CHS supports the same DASD devices that are 
supported by the CP portion of VM/370. CMS 
formats the tracks of a CBS disk into 
fixed-length blocks. The CHS file system 
then manages these blocks in such a way 
that the user appears to have logical 
fixed- or variable-length records, and 
sequential or direct access to files. 

In addition to reading and writing CMS 
files, CHS can read sequential or VSAH DOS 
files and sequential, partitioned, or VSAH 
OS data sets. 

Problem programs that execute in CMS can 
create files on unlabeled tapes in any 
record and block size; the record format 
can be fixed, variable, or undefined. 

CHS automatically opens and closes all 
accessed files (including spool files) for 
each command or user program it executes - 
Files can be spooled between virtual 
machines to transfer files between users. 
Service programs invoked by CMS commands 
also manipulate files. CMS files can be 
written onto and restored from unlabeled 



Conversational Monitor System 21 



320Kr 




©I Virtual \ 
1 Tape ) 



System 
Disk 

(Read-only! 




User 
Disk 

I Read/Write) 



Virtual 

Card 

Reader/Punch 



Virtual 
Printer 



Figure 9. Sample CMS Configuration 



tapes via CMS coamands, 
not supported by CMS. 



Tape labels are FILE IDENTIFICATIOH 



CMS has files that contain nacro 
libraries and program libraries, and 
commands to use and update these libraries. 
The user or installation can create 
additional macro and program libraries, if 
needed. 



DSER DISKS 



CMS requires the system residence volume to 
be online. Each user may have up to nine 
virtual disks online at any one time. (all 
nine of these can reside on one real disk.) 

The user disks are differentiated by a 
filemode designator, assigned when the disk 
is made active. The filemode consists of a 
letter and a number. The number indicates 
the disk's access mode and the letter 
defines a standard order-of-search for disk 
files. 

Each virtual disk may be defined as 
read-only or read/write, and may be shared 
among users. 



CMS user files are identified by a fileid 
consisting of three designators: 

• filename (fn) — is an 8-character name 
assigned the file by the user. 

• filetype (ft) — is the identification 
given to specify particular file 
characteristics. 

• filewe^de (fn) — describes the disk that 
contains the file and the access mode 
assigned to the file. 



SAMPLE ASSEMBLE A1 



Figure 10. CMS File Identification 



Figure 10 is a sample CMS file with an 
identification of SAMPLE, ASSEMBLE 
indicates that the file consists of 
assembler language source statements, A 
indicates that the file is located on the 
A-disk directory, and 1 indicates that the 
file has a read/write access mode. 
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FILE STRUCTOHE 



CMS disk files are written 
records, which usually are 
contiguous on the disk. They 
and deallocated automatically 
file size demands. Each virt 
master file directory, or the 
user file directory, contain 
size information for each 
virtual disk. This director 
pointer to the file's chain 1 
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Figure 11 illustrates the CMS file 
structure. The user file directory entry 

points to the chain link records for that 
file, each of which points to a separate 
800-byte record of the file. 
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Initialization and Dump Restore 



The OS IBCDASDI service program initializes 
all types of real and virtual minidisks 
supported by VM/370. 



The CBS 
minidisks for 
program must 
minidisk that 
catalogs. 



FORMAT command initializes 
CMS. However, the IBCDASDI 
be used to initialize any 
is used with VSAM files or 



Most CMS commands can be entered by the 
user in a truncated form (for example, "a" 
can represent "assemble") . CMS keeps an 
ordered list of command names, from which 
it determines which command the truncated 
fori represents. The installation can 
modify the sequence of the command list and 
the valid limits of truncation. 

Each user (or installation) can define 
synonyms for any or all command names. 

Any executable program stored on a CMS 
system or user volume can be invoked by 
name as a command. To execute a program, 
the user must enter on the terminal the 
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operands. 



The EXEC processor of CMS can be used to 
define new commands that are combinations 
of existing commands. Such new commands, 
called EXEC procedures, eliminate the 
tedious rekeying of frequently used 
sequences of commands. The EXEC processor 
has logical capabilities; EXEC procedures 
can test the contents of variables, branch 
on specified conditions, and execute 
programmed loops. A special EXEC procedure 
called a PROFILE EXEC can be invoked 
automatically when xhe user issues his 
first command in the CMS environment; it 
initializes that user's virtual machine 
according to the information in his PROFILE 
EXEC file. 



Program Development and 
Execution 

CMS has a wide range of programming 
development capabilities, it can: 

• Create and compile source programs 

• Build test files 

• Execute and test programs 

• Debug programs at the terminal 



A CP format program formats CP-owned 
volumes, such as the system residence, 
paging, and spooling disks. 

The DASD Dump Restore (DDR) program of 
VM/370, which executes standalone or under 
CMS, dumps, restores, and displays all 
types of minidisks. 



PROGRAM COMPILATION AND EXECUTION COMMANDS 



CMS Command Language 



The CMS command language is flexible and 
can be tailored by the installation or by 
individual users. 
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Figure 11. CHS File Structure 
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The DOS linkage editor is siaulated in 
CMS. Files to be link-edited can be read 
froa DOS libraries. CMS link-edits files 
and places the output in a CHS file called 
DOSLIB and accepts the DOS linkage editor 
control stateaents as input. 



LANGDAGE PROCESSORS 



A VH/370 assembler is distributed as part 
of the VM/370 system and is reguired for 
installation and support. All necessary 
macros for installation and support are 
provided in CMS libraries. 

A variety of prograaaing languages are 
available for use with CMS. VS APL, 
VSBASIC, DOS and OS PL/I, and OS FOHTRAH 
are useful languages for problem-solving 
applications. DOS/VS and OS/YS COBOL, DOS 
and OS PL/I and asseabler languages are 
useful for coaimercial program development 
applications- 



Host object programs produced and 
coapiled under CHS may be executed under 
CHS for direct problem solving. Programs 
that use certain OS system functions must 
be run under the appropriate operating 
system. 



INTEGRATED EHOLATOHS 

Emulator-dependent programs (except for DOS 
emulation under OS or OS/VS) that execute 
on a System/370 equipped with the 
appropriate compatibility features can 
execute en that Systea/370 in DOS or OS 
virtual machines under VB/370. 

No modifications are required to be made 
to emulators, to DOS or OS, or to VH/370 to 
allow emulator-dependent programs to 
execute in virtual machines. 

In an attached processor (AP) system, a 
virtual machine can use the SET AFFINITY 
command to make use of an emulator 
installed on only one of the processors. 
The directory option for affinity may be 
used instead, with similar results. 



THE CHS EDITOR 



The CHS Editor consists of the EDIT comaand 
and its subcommands. With the CHS Editor, 
a user can create a file by typing the data 
in at the terminal. He can scan all or 
part of the file, and insert, change, or 
delete records. 
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SCRIPT/370 



SCRIPT/370 is a text processor available 
as an IDP (Installed User Program) for use 
under CMS- SCRIPT/370 includes manuscript 
facilities that create formatted output 
from one or more CMS files containing text 
and/or text-manipulating control words. 
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Synonyms for command names may be 
created by a user via entries in a CMS file 
with a filetype of SYNONYM. 

The EXEC command specifies a file of CP 
and CMS commands, as well as conditional 
branching and control statements, which are 
executed in a predetermined sequence by the 
EXEC processor of CMS. 
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DEEUGGING FACILITIES 



The debugging facilities of CMS permit a 
user to set instruction address stops in 
his program, to examine and modify virtual 
registers and virtual storage, and to trace 
all SVC interrupts. User-selected 
interrupts may be traced with output 
directed to either a virtual printer or the 
terminal. 



CMS BATCH FACILITY 



ALTERNATING OPERATING SYSTEMS 



If a program to be tested uses OS and DOS 
functions that are not simulated, or if the 
program is designed for some other 
operating system, the user may execute the 
two operating systems alternately. The 
virtual machine must be configured to run 
both CMS and the other operating system. 



The CMS batch facility is a VM/370 
programming facility that executes under 
CMS. It allows a VM/370 user to execute 
jobs in batch mode by sending jobs from 
either his own virtual machine or the real 
card reader to a virtual machine dedicated 
to running batch jobs under the batch 
facility. The batch facility virtual 
machine then executes these jobs, freeing 
the user's virtual machine for other uses. 
The accounting routines charge the time 
used in the batch machine to the 
originating user. 
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Remote Spooling Communications Subsystem 



The VM/370 remote spooling coimunications 
subsystem (RSCS) is the VM/370 component 
that runs under CP control. RSCS provides 
telecommunication support to transfer files 
between remote stations and virtual 
machines using binary synchronous (BSC) 
switched or nonswitched lines. 

RSCS cannot be operated without CP. 
RSCS, together with the spool file system 
of CP, provides a telecommunication 
environment for the transfer of files from; 

Virtual machines to RSCS remote stations 



RSCS remote stations 
remote stations 



to other RSCS 



Virtual machines to remote job entry 
batch system 

RSCS remote stations to job entry batch 
systems 

RSCS remote stations to a CMS batch 
virtual machine 

Some examples of remote job entry batch 
systems are: HASP, ASP, JES, RES, and CRJE. 
These job entry batch systems, run under 
the appropriate system control program such 
as: DOS, DOS/VSE, OS, or OS/VS. 



RSCS has a supervisor and line drivers. 
The supervisor is an interface between the 
CP spool system and the RSCS line driver. 
The line drivers drive, or control, a 
specific type of remote station. 

For details concerning RSCS refer to the 
VM/370 Benote Spoolina Communications 
Subsystem (RSCS) User2.s Guide. 

Figure 12 shows the relationship among 
the VM/370 virtual machine users, the CP 
spool system, and the remote stations. 



The RSCS Teleprocessing Network 



The RSCS network consists of a real 
processor, transmission control units, and 
BSC telecommunications lines and remote 
stations. 



THE REAL PROCESSOR 



A real processor that is executing VM/370, 
and RSCS in a virtual machine, is the 
center of the RSCS teleprocessing network. 
The operator of the RSCS virtual machine 
controls the network by issuing RSCS 
commands from his terminal. 

The CP spool system is an integral part 
of the RSCS teleprocessing network. All 
files transmitted between remote locations 
and VM/370 virtual machines are routed 
through the CP spool system via the RSCS 
virtual machine. 



HSCS TELEPROCESSING HARDWARE REQUIREMENTS 
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REMOTE STATIONS 



RSCS remote stations are input/output (I/O) 
configurations. The minimum configuration 
consists of a card reader, a printer, and a 
card punch. There are two types of remote 
stations: programmable and nonprogrammable. 
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Figure 12. A VM/370 RSCS Teleprocessing Network 
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LINKING 
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GEOGRAPHIC LOCATIONS IN THE RSCS 



Nonprogrammable remote stations are I/O 
configurations that cannot be programmed, 
but can receive, read, print, punch, and 
send files. An example of a 
nonprogrammable remote station is a 2780 
Data Transmission Terminal- 



Using RSCS 



The facilities of RSCS are selected and 
controlled by commands and control cards. 
Connections between geographically remote 
locations are made by the operator of the 
RSCS virtual machine. 



Each location in the RSCS network is 
assigned a location identifier, which RSCS 
uses to find a link, or path, to the remote 
location. 

To link a remote station to a virtual 
machine, the RSCS operator issues the START 
command. Then, to begin transmitting to 
the RSCS virtual machine, the remote 
station operator transmits a SIGNON card. 
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to transmit the file to the designated 
virtual machine. If tag information is 
also supplied, RSCS can transmit the file 
to another remote station. 



system, defining or deleting a link in the 
system, repositioning a file forward or 
backward during processing, disconnecting 
the RSCS virtual machine console, and so 
on, are provided hy the system. 



COMMANDS FOR TRANSMITTING FILES 
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Transmitting Commands To Be Executed b^ 
Oii§I Systems 
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COMMANDS FOR CONTROLLING THE 
MACHINE AND REMOTE STATIONS 



RSCS VIRTUAL 



RSCS has commands and control cards that 
control the operation of the RSCS system. 
The system control functions are executed 
by the RSCS control program when it 
receives commands entered either from a 
console or via punched cards. 

The RSCS virtual machine operator can 
use all the RSCS commands to control the 
system; operators at remote stations use a 
subset of the commands available to the 
RSCS virtual machine operator. In general, 
functions such as purging a file from the 



REMOTE SPOOLING COMMDNICATIONS SUBSYSTEM 
NEIUORKING 



The Remote Spooling Communications 
Subsystem Networking program product 
(Program Number 57U8-XP1) provides enhanced 
networking facilities to a VM/370 system. 

RSCS Networking is a complete virtual 

machine subsystem that operates 

independently of other operating systems 
running under CP. 

For further information concerning RSCS 
Networking, refer to the RSCS Networking 
General Information Manual, GH24-5004 and 
the RSCS Networking Pr ogram Re ference and 
Operations Manual, SH24-5005. 
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Interactive Problem Control System 
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The IPCS component: 

Facilitates online problem management 
and interactive problem diagnosis. 

Provides an analysis function for CP 
dumps; the resultant extracted data 
resides on disk as a unique problem 
report. 

Has a prompting program for 
user-detected failures; the resultant 
data resides on disk as a unique problem 
report- 
Searches for duplicate problems and 
informs the user when a problem with 
similar symptoms was previously 
experienced at the installation. 

Has a problem-tracking facility that 
updates and displays problem status. 

Has an interactive debugging facility 
that aids in the analysis of 
disk-resident CP abend dumps. 



reports and symptom summary file are kept 
on disk. 

More information concerning the 
operation of IPCS can be found in the 
VM/370 Interactive Problem Control System 
7lPCS) Dser^s Guide, GC20-1823. 



PBCELEM REPORT GENERfiTIOM 



IPCS can be used to report two types of 
problem situations. They are: 

• CP system detected failures 

• All user-detected failures 



IPCS COMMANDS 



IPCS commands are invoked 
virtual machine. They are: 



xroB 



:ms 



D0MPSC4H 

provides the system analyst edit 
facilities to obtain, via the terminal 
console, pertinent data from a system 
dump for quick analysis. 

PRE 

provides a means of updating the status 
of reported problems. 

PROE 

provides the user with a means of 
entering problems into the IPCS 
reporting system that are not associated 
with CP abend dump conditions. 



STAT 

provides a means of interrogating 
problem report files. 



the 



Conditions of Operation 



VMFEDMP 

provides a formatted dump and a system 
generated problem report for the IPCS 
system. 



The amount of available IPCS virtual 
machine A-disk space can affect the 
operation of IPCS. 

When an adequate amount of storage is 
available, all problem reports, dumps, 
supplementary data files, and the symptom 
summary file are stored on disk. When 
storage is at a premium, only the problem 



PRELIMINARY CONSIDERATIONS 



Problem determination and resolution often 
require analysis of other data in addition 
to CP abend dumps. This data is called 
supplementary data in the IPCS system. 
Procedures must be established for 
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collecting 
situation. 



data prior to the problem 



Some methods used to collect data are: 



Spooling 
console 



of the systei 



operator's 



Virtual lachine dumps 
Trace output 



For more detailed information regarding 
IPCS, refer to VM/370 Interactive Problem 
Control System (IPCS) D s erj,s Guide. 



IHSTALLISG IPCS 



The installation of CHS includes the IPCS 
component of VM/370: the VH/320 Planning 
§S^ System Generation. GC20-1801 details 
the system generation procedures. 
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Appendix A: VM/370 Publication-to-Audience Relationship 



The following illustrates the relationship 
of the VM/370 publications to their 



appropriate audience and also includes 
brief description of the text content. 



Audience 



Publications 



Content 



All users 



Introduction, GC20-1800 



Overview of VB/370 and 
virtual machines 



CP Comnand Reference 
for General Osers, 
GC20-1820 



G and "Any" commands 
needed for virtual 
machine control 



System Messages, 
GC20-1808 



Abend codes, wait 
states, and messages 



Terminal User's Guide, 
GC20-1810 



Logon/Logoff, virtual, 
console terminal use, 
attention handling 



Quick Guide for Users, 
GC20-1926 



Reference for coimand and 
service program control 
statement formats 



System Analyst, 
Programming System 
Representatives, 
Installation Planners 
and Support Personnel 



Release 6 Guide 
GC20-183a 



VM/370 planning 
information for 
Release 6 



Planning and System 
Generation Guide, 
GC20-1801 



VM/370 installation 
requirements and 
procedures 



Operator's Guide, 
GC20-1806 



VM/370 system control 
commands, resources, 
control, service 
programs, spooling 



System Programmer's 

Guide, 

GC20-1807 



Resources for problem 
solving, tracking, 
tracing, monitoring 



Operating Systems in a 
Virtual Machine, 
GC20-1821 



Relationship of VM/370 
with other operating 
systems, VM/370 concepts 



OLTSEP and Error 
Recording Guide, 
GC20-1809 



OLTS from a virtual 
environment. RMS, 
invoking CPEREP 



CMS Command and Macro 
Reference, GC20-1818 



CMS User's Guide, 
GC20-1819 



CMS facilities for 
generating, compiling 
editing, testing and 
debugging programs 



OS/VS, DOS/VSE, VM/370 
Environmental Recording 
Editing and Printing, 
GC28-0772 



Provides details on 
OS/VS, DOS/VSE, and 
VM/370 EREP operands 
invoked by CPEREP 
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r ■ ■ ■ ■ ' ' "1 

1 Audience | Publications | Content I 


1 System Analyst, | Interactive Problem | Catalog and update j 
jprogramming System IControl System (IPCS) | facility for recorded | 
IRepresentatives, | User's Guide, Isystem and virtual | 
1 Installation planners |GC20-1823 | machine problems j 


1 (cont.) 1 Service Routines IVH/370 logic on CP, CMS I 
1 1 Program Logic, land HSCS; the service | 
1 ISY20-0882 1 programs; OS/VS EBEP | 


1 IData Areas and Control j control blocks that I 
1 IBlock Logic, SY20-088U |relate to those | 


1 1 System Logic and j 1 
1 1 Problem Determination, I 1 
1 IVol 1 - CP, SY20-0886 | I 
I IVol 2 - CMS, SY20-0887 1 I 
1 IVol 3 - RSCS, SY20-0888I | 


1 lOS/VS, DOS/VSE, VB/370 | | 
1 1 Environmental Recording I I 
1 1 Editing and Printing I I 
1 1 (EREP) Program Logic, | I 
1 ISY28-0773 | ( 


JField Engineer (CE) lOLTSEP and Error |OLTS from the virtual j 
1 1 Recording Guide, | machine, RMS, and | 
1 IGC20-1809 1 Invoking CPEREP | 


1 1 OS/VS, DOS/VSE, VM/370 | Provides details on OS/VS | 
1 1 Environmental Recording I BOS/VSE and VH/370 EBEP | 
1 1 Editing and Printing | operands invoked by | 
1 IGC28-0772 1 CPEREP | 


1 System Operator jOperator's Guide, | Resource and system j 
1 IGC20-1806 1 control command and | 
i I {service programs; IPL I 
1 1 1 VM/370 1 


1 1 Remote Spooling | Operational control of | 
1 ICommunications {remote spooling j 
1 1 Subsystem (RSCS) Dser'sl I 
1 IGuide, GC20-1816 j I 


1 |CP Command Reference |G and any commands — | 
1 jfor General Osers, {Heeded for CP virtual | 
1 IGC20-1820 {machine CP control { 


( {Operating Systems in a {Relationship of VM/370 { 
{ {Virtual Machine, {with other operating | 
{ {GC20-1821 {systems { 
1 1 {Expands the information { 
( { {on G command usage j 


( {Interactive Problem {Tracking facility for ( 
{ {Control System (IPCS) {system and virtual j 
{ {Dser's Guide^ GC20-1823 1 machine problems { 


{ jOLTSEP and Error {How to invoke CPEREP to { 
{ {Recording Guide, {capture/clear SYS1.LCGREC{ 
{ IGC20-1809 {and VM/370 error { 
1 1 (cylinders | 
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Audience 



I 

I Publications 



I 

I Content 



Application 
Programmer, 
Interactive users — 
Anyone who needs to 
create or modify 
programs or data 



I Release 6 Guide 
IGC20-1834 



IVM/370 Planning inforaa- 
Ition for Release 6 



|CMS Command and Macro 
i Reference, GC20-1818 



I CMS command formats for 
I program creation, editing 
Itesting and debugging 



|CMS Oser's Guide, 
IGC20-1819 



ITetailed use of 
I CMS commands 
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Appendix B: VM/370-Related Publications For CMS Users 



This appendix lists VH/370-related 
publications for CMS users. The following 
VM/370 publications contain general 
inforaation concerning CMS for new users: 

VM/370 Quick Guide for Osers* GX20-1926 
VM/370 Commands (General Oser) i GX20-1961 
VM/370 Commands (Other that GX20-1995 

vjciiej-a-L uoci./ - 

VM/370 CMS Command and Macro GC20-1818 

Reference 
VM/370 CMS User's ^uide GC20-1819 



Corequisite Publications 



VM/370 Introduction GC20-18C0 

VM/370 System Messages GC20-1808 

VM/370 Terminal User's Guide GC20-1810 



VS BASIC: Quick Guide for CMS SX28-6386 

Users 
VS BASIC: Installation Reference SC28-8309 

Material 
VS BASIC: Language Reference GC28-8303 

Manual 



BASIC Suti- Ou tiue usej. 

MATH/BASIC- General Information GH20-1128 

Manual 
MATH/BASIC, Program Reference SH20-1158 

Manual 
STAT/BASIC, Program Reference SH20-1069 

Manual 
STAT/BASIC, General Information GH20-1027 

Manual 
Business Analysis/BASIC, Program SH20-1264 

Reference Manual 
Business Analysis/BASIC, General GH20-1175 

Information Manual 



Also Available 



Assembler User 



Virtual Machine Facility/370 GC20-1757 
Features Supplement 

CMS for Programmers, A Primer SR20-4U38 

The publications that are relevant to a 
particular type of CMS user are listed by 
categories of CMS users. Since titles 
change and new publications are constantly 
being added to the IBM library, this list 
should serve only as a guide to what is 
currently available. For a more 
up-to-date list, see the IBM S2stem/320 
E ibl i ojr ajB hy , Order No. GC20-0001. 



Note: In seme cases, the 
abbreviated to save space. 



titles are 



VS BASIC User 

VS BASIC CMS Terminal User's 

Guide 
B is for BASIC. An Introduction 

to VS BASIC under CMS 
VS BASIC, General Information GC28-8302 
VS BASIC, Program Product Design GC28-8301 

Objectives 



SC28-8306 
SC28-8310 



iThese three reference summaries are 
available separately or can be ordered at 
the same time by using Order No. 
GBOF-3576. 



OS/VS and VM/370 Assembler 

Programmer's Guide 
OS/VS, DOS/VS, and VM/370 

Assembler Language 
VM/370: System Programmer's 

Guide 



SCRIPT User 



GC33-U021 
GC33-U010 
GC20-1807 



SH20-1857 



SCRIPT/370 User's Guide 

Program No. 5796-PH6 
SCRIPT/370 Systems Guide LY20-2251 
SCRIPT/370 Quick Guide for Users GX20-1997 

Reference Summary 



FORTRAN User 



SC28-6891 



VM/370 (CMS) Terminal User's 

Guide for FORTRAN IV Program 

Products 
IBM FORTRAN Program Products for GC28-6884 

OS and the CMS Component of 

VM/370: General Information 
FORTRAN IV (G1) Code and Go 

Terminal User's Guide 
IBM OS Code and Go FORTRAN and 

FORTRAN IV (Gl) Programmer's 

Guide 
FCHTRAN TV (G1) Processor and 

TSO FORTRAN Prompter for OS 

and VM/370 (CMS) : Installation 

Reference Material 



SC28-6842 
SC28-6853 

SC28-6856 
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OS/VS VSiM User 



IBH OS FORTRAN IV Library SC28-6858 

(Mod 1) for OS and VK/370 

(CMS) Installation Reference 

Manual 
IBM Code and Go FORTRAN SC28-6859 

Processor for OS and VM/370 

(CMS) Installation Reference 

Material 
IBM OS FORTRAN IV (H Extended) SC28-6852 

Compiler, Programaer 's Guide 
IBM OS FORTRAN IV (H Extended) GC28-6865 

Compiler and Library (Mod II) , 

Messages 
IBM FORTRAN IV (H Extended) SC28-6861 

Compiler and FORTRAN Library 

(Mod II) for OS and VM/370 

(CMS) Installation Reference 

Material 
IBM OS FORTRAN IV Mathematical SC28-6864 

and Service Subprograms 

Supplement for Mod I and 

Mod II Libraries 
IBM FORTRAN IV Library GC28-6818 

Mathematical and Service 

Subprograms 
FORTRAN Interactive Debug for OS SC28-6886 

(TSO) and VM/370-CMS 

Installation Reference Manual 
FORTRAN Interactive Debug for OS SC28-6885 

(TSO) and VM/370 (CMS) 

Terminal User's Guide 
IBM FORTRAN Interactive Debug SX28-8193 

for OS (TSO) and VM/370 (CMS) 

Reference Card 
FORTRAN IV Language GC28-6515 PL^I User 



DCS/VS COBOL Compiler and SC28-6478 

Library Programmer's Guide 
DCS/VS COBOL Compiler and SC28-6a79 

Library Installation Reference 

Material 
VH/370 CBS User's Guide SC28-6469 

for COBOL 

£CS^VSE VSAM and CMS VSAM Users 

DOS/VSE Macro User's Guide GC24-5139 
DCS/VSE Macro Reference GC24-5iaO 

Using VSE/VSAM Command and GC33-5382 

Macros 
DCS/VSE Data Management Concepts GC24-5138 



OS/VS VS 
0S/VS2 P 

Data M 
OS/VS VS 
OS/VS Ac 
OS/VS VS 
OS/VS VS 

Applic 
OS/VS Da 

Servic 
OS/VS Ac 
OS/VS Pi 
0S/VS2 A 
Planning 

OS/VS 



AM System Information 
rogramming Library: 
anagement System 
AM Programmer's Guide 
cess Method Service 
AM Planning Guide 
AM Options for Advanced 
ations 

ta Management 
es Guide 

cess Method Services 
anning and Use Guide 
ccess Method Services 
for Enhanced VSAM under 



GC26-3835 
GC26-3830 

GC20-3818 
GC35-0009 
GC26-3799 
GC26-3819 

GC26-3783 

GC26-3836 
GC24-5090 
GC26-3841 
GC26-3842 



COBOL User 



Note: "IBM OS Full American National 
Standard COBOL" has been abbreviated to 
"OS ANS COBOL" in the following list. 



OS ANS COBOL 

OS ANS COBOL 
Library, Ve 
Programmer' 

OS ANS COBOL 
Reference M 

OS ANS COBOL 

OS ANS COBOL 
Guide 

OS COBOL Inte 
Terminal Us 
Reference 

OS COBOL Inte 
Installatio 
Material 

OS/VS COBOL C 
General Inf 

OS/VS COBOL C 
Library ins 
Material 

OS/VS COBOL C 
Programmer' 



Language Manual 


GC28- 


-6396 


Compiler and 


SC28- 


-6456 


rsion 4, 






s Guide 






Installation 


SC28- 


-6458 


anual 






Messages, Version 4 


SC28- 


-6457 


Version fi Planning 


SC28- 


-6431 


ractive Debug 


SC28- 


-6465 


er's Guide and 






ractive Debug 


SC28- 


-6468 


n Reference 






ompiler and Library 


GC28- 


■6470 


ormation 






ompiler and Library 


SC28- 


-6481 


tallation Reference 






ompiler and Library 


SC28- 


■6483 


s Guide 







OS PL/I Cptimizin 

Program Product 
OS PL/I Cptimizin 

Programmer's Gu 
OS PL/I Cptimizin 

Messages 
OS PL/I Cptimizin 

Execution Logic 
OS PL/I Cptimizin 

Installation 
OS PL/I Cptimizin 

CMS User's Guid 
OS TSO PL/I Optim 
OS PL/I Cptimizin 

General Informa 
OS PL/I Checkout 

General Informa 
OS PL/I Checkout 

Program Product 
OS PL/I Checkout 

Programmer's Gu 
OS PL/I Language 

Manual 
OS PL/I Checkout 

Messages 
OS PL/I Checkout 

Installation 
OS PL/I Checkout 

User's Guide 
OS PL/I Checkout 

Execution Logic 



g Compiler, GC33-0022 

Specifications 

g compiler, SC33-0006 
ide 

g Compiler, SC33-0027 

g Compiler SC33-0025 

g Compiler SC33-0026 

g Compiler SC33-0037 

e 

izing Compiler SC33-0029 

g Compiler GC33-0001 

tion 

Compiler: GC33-0003 

tion 

Compiler GC33-0030 

specifications 

Compiler SC33-0007 
ide 

Reference GC33-0009 

compiler SC33-0034 

Compiler SC33-0031 

compiler TSO SC33-0033 

Compiler - SC33-0032 
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OS PL/I Checkout Compiler, SC33-00a7 

CMS User's Guide 
OS PL/I Resident Library GC33-0023 

Program Product Specifications 
OS PL/I Transient Library GC33-002a 

Program Product Specifications 
COS PL/I Checkout Compiler GC33-0016 

Program Product Specifications 
DOS PL/I optimizing Compiler SC33-0020 

Installation 
DOS PL/I Optiaizing Compiler GC33-0008 

Programmer's Guide 
DOS PL/I Optimizing Compiler SC33-0051 

CMS User's Guide 

cr- 1-3— nm 1 

tj\^ ^ ^ W W J^ I 



DOS PL/I Resident Library GC33-0017 
Program Product Specifications 

DOS PL/I Transient Library GC33-0018 
Program Product Specifications 



■nr>c TIT /T 



Messages 



VS APL User 

VS APL: Terminal User's 

Guide for CMS 
VS APL for CMS: Writing 

Auxiliary processors 
VS APL: Reference Summary 
VS APL: Installation Reference 

aa. uc J. j-aJL 

VS APL: General Introduction 
APL Language Reference 



SH2 0-9067 

SH20-9068 
SX26-3712 

^H^ \j~" 06_i 
GH20-9064 
GC26-3847 
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Index 



A 
access 

■ode 22 

read-only 15 

read/write 15 

to real processor 13 

to virtual device 15 
accounting, virtual aachine 9-10 
affinity, description of 8-9 
allocating 

page frames 8-9,14 

real disk storage 15 

real storage 14 
alternating operating systeas 25 
AP ( se e attached processor) 
applications 

batch 8 

of performance options 8-9 

programming 7 

?M/370 6 

interactive use 8 
operations 7 
assembler, VM/370 24 
attached processor 

disabling the 18 

support of 18 
AUTOLOG command 5 



6 

backup 8 

batch 

applications 8 

facility (see CMS Batch Facility) 

operating systems, and RSCS 29 

virtual machine 25 
batch systems, supported 6 
block multiplexer channel mode 16 
byte multiplexer mode 16 



chain link record 22 
channel 

indirect data addressing 15 

mode 16 
channel-to-channel adapter 

attached 16 

virtual 4 



25 



CMS (see CMS (Conversational Monitor 

System)) 
CMS (Conversational Monitor System) 1 
Batch Facility 25 
command language 23 
commands ( see CMS commands) 
configuration 21 
debugging facilities 25 
description of 21 
directory entry 21 
disk, support 22 
EDIT command 25 
Editor 25 
EXEC 

procedures 24 

processor 24 
file directory 22 
file identification 22 
file system 21 
files 

format 23 

structure 23 

system 21 
IBM programs executable under 24 
language processors 24 
nucleus 21 
performance of virtual machine executing 

15 
read/write disk, size of 21 
shared segment of 21 
storage size 21 
support 

of disks 21 

of tapes 21 

of unit record devices 21 
system disk 21 

read-only 21 

read/¥rite 21 
user disk 22 
user files 21,22 
VM/370-related publications 37 
CMS commands 24 
control 25 
EDIT 25 
that invoke 

DOS Linkage Editor 24 

OS compilers and assembler 24 
that provide library services 25 
CMS component 21 
CMS editor, using 25 
collecting performance data 9 
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command language, CMS 23 
command names, synonyms 24 
commands 

for controlling BSCS 29 

for transmitting files 29 

IPCS 31 
commands (see also CMS commands and CP 

commands) 
communication 

with other real computing system 6 

with other virtual machines 6,19 
communication facility, virtual machine 11 
compilers executable under CMS 24 
compiling programs under CMS 25 
component 

of VM/370 
CMS 1,21 
CP 1,13 
IPCS 1,31 
RSCS 1,27 
coipoTients, of VM/370 1 
concurrent execution, of virtual machines 

1-2 
condition code 15 

configuration, of CMS virtual machine 21 
consideration, IPCS 31 
console spooling 17 
control commands, CMS 25 
control unit 

DASD 3 

telecommunications 3 
control units, virtual transmission 4 
conversational, user, definition of 13 
Conversational Monitor System ( see CMS 

(Conversational Monitor System)) 
conversion, of operating system 8 
CP (see CP (Control Program)) 
CP (Control Program) 1 

description 13 

privilege class descriptions 18 
CP commands 17 

ADTOLOG 5 

DIAL 6 

general users 17 

INDICATE 9 

LINK 5,15 

LOGON 5 

MONITOR 9 

other users 18 
CP component 13 

creating a virtual machine 5,13 
creating manuscripts, under SCRIPT/370 25 



data addressing, channel indirect 
data collection, IPCS 32 
debugging facilities, CMS 25 



15 



dedicated 

channel 15 
device 15 
developing programs 7 
device 

paging 14 
virtual 

dedicated 15 
operation of 15 
shared 15 
devices 

dedicated 3 
virtual, unit records 4 
virtual I/O 3 
DIAGNOSE interface 16 

used by CMS 21 
DIAL command 6 
directory 
entry 

contents of 13 
for CMS 21 
password 5 
privilege class 17 
size of virtual storage 13 
user identification 5 
file 

VM/370 5,13 
VM/370 1 
discontiguous segment 
nonshared 10,14 
saved 10 
shared 10,14,21 
disk volume, 2319 4 
disks 

read-only 21 
read/write 21 
real 4 

support, CMS 22 
system 21 
user 21 
virtual 4 
display 

devices, editing at 25 
of password, inhibiting 5 
displaying performance data 9 
dynamically modified channel programs 15 



editing files at display terminals 25 
Editor, CMS 25 
emulators 24 

integrated, that execute under VM/370 
24 
error 

analysis 9 

recording 9 
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EXEC 

procedures, of CMS 24 

processor, of CMS 24 
execution 

concurrent, of virtual machines 1-2 

independent, of virtual machines 1-2 



favored execution, description of 8-9 
FDPs (see Field Developed Programs) 
Field Developed Programs (FPDs) 6 
file 

directory, CMS 22 

structure, of CMS 23 

system, of CMS 21 
file identification, CMS 22 
fileid 22 
filemode 22 
filename 22 
files 

CMS 21 

identification 22 
filetype 22 



first level storage 14 
f« (§§6 filemode) 
fn (See filename) 
ft (See filetype) 



integrated emulators 24 
interactive 

system 

multiple-access 8 
single user 8 

use, VM/370 applications 8 
interrupt handling 15 
invoking, operating system 5 
I/O 

management 15 

operations 16 
initiating 15 
IPCS, component 31 
IPCS ( se e IPCS (Interactive Problem Control 

System) ) 
IPCS (Interactive Problem Control System) 
1 

coaaands 31 

component 31 

considerations 31 

data collection 32 

description 31 

installation 32 

operation 31 
IDPs ( see Installed Dser Programs) 



JCL (job control language) 7 
security 5 



general user 17 
generating, system 6-7 



handshaking, VM/7S 19 
high-speed, printer 3 



IBCDASDI disk initialization program 23 
IBM program products, excutable under CMS 

24 
identification, user (userid) 5 
inactive pages 14 
INDICATE command 9 
inhibiting display of password 5 
initialization and dump/restore program 23 
input, spool files 16 
input/output (see I/O) 
installation, IPCS 32 
Installed User Programs (IDPs) 6,7 



language processors 24 

executable under CMS 24 
languages, programming, available with CMS 

24 
line, drivers, BSCS 27 
link, record, chain 22 
LINK command 5,15 
linking 

geographic locations in the RSCS network 
28 

virtual machines and remote stations 29 
loading, operating system 5 
location identifier, RSCS 28 
locations, RSCS, linking 28 
locked pages, description of 8-9 
logging on, VM/370 5,13 
logon, procedure, VM/370 5 
LOGON command 5 
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Mass Storage Control (MSC) 3 
Mass Storage Pacility (MSF) 3 
Hass Storage System (HSS) 3 

voluies 3 
■azinuB storage size 13 
■inldisks 

description of 4 

initializing 23 
■ode 

batch 8 

block multiplexer 16 

byte multiplexer 16 

?S1 nonpaging 19 
MONITOR command 9 

MSS (see Mass Storage System (MSS)) 
multiple 

operating systems, consecutive use of 

virtual machines 2 
multiple-access systems, supported 6 



N 

networking, using RSCS 29 
nonconversational user, definition of 13 
nonprogrammable remote stations, RSCS 28 
normal and virtual=real virtual machines 

15 
normal storage size 13 
NPT (nonprogrammable terminal) 27 





operating systems 
alternating 25 
invoking 5 
loading 5 
single-user 1 
supported 
batch 6 

conversational 6 
description of 6 
multiple-access 6 
single-user 6 
use of multiple consecutive 7 
virtual machine 14 
operation, IPCS 31 
operations, applications 7 
OS (Operating System), performance of 

virtual machine executing 15 
output, spool files 17 



P 

page 14 

faults, pseudo 19 

frames 

description of 14 
real storage 14 
reserved 8-9 

table, shadow 14 

zero 14 
paging 14,15 

device 14 

operations 14 

requirements 8-9 
password 5 

for device sharing 15 

inhibiting display 5 
perferred virtual machines 8-9 
performance 

analysis, description of 9 

collecting data 9 

displaying data 9 

factors influencing 15 

measurement, description of 9 

of virtual machine 14 

system 15 
performance option 

affinity 8-9 

extended control- prog ram support 

favored execution 8-9 

locked pages 8-9 

priority option 8-9 

reserved page frames 8-9 

virtual=real 8-9 

virtual machine assist 8 
printer, high-speed 3 
priority option, description of 8-9 
privilege, classes 17 
problem, state 13 
processor, attached, using 18 
program 

compilation commands, CHS 24 

design 16 

development 7,24 

development and execution 24 

execution 24 

execution commands, CMS 24 
programmable remote stations, RSCS 
programming 

applications 7 

languages, available with CMS 24 

systems 6 
protection, shared segment 10 
pseudo page faults 19 
publications 

VM/370 

for CMS users 37 
relationship of 
publication-to-audience 33 
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R 

read-only, access 15 
read/write, access 15 
real disks 

description of 4 
partitioned into minidisks 4 
real storage 

page frame 14 
size 14 
remote spooling 17 

Remote Spooling Communications Subsystem 
(RSCS) (see RSCS (Remote Spooling 
Communications Subsystem)) 
remote stations 
RSCS 

definition of 27 

linking to virtual machines 29 

RSCS, component 27 

RSCS (Remote Spooling Communications 
Subsystem) 1, 17 

controlling 29 

description of 27 

ID card 29 

line drivers 27 

linking locations 28 

networking 29 

remote job entry 29 

remote stations 27 

linking to virtual machines 29 

supervisor 27 

teleprocessing hardware requirements 27 

teleprocessing network 28 

transmitting files 29 

using the RSCS network 28 

virtual machine 27 

7M/370 computer 27 
running multiple partitions 6 



sample directory entry 5 
saved 

discontiguous, segments 

systems 9-10 
SCRIPT/370 7 

using 25 
second level storage 14 
security, of password 5 
segment 

description of 14 

discontiguous saved 10 

shared 14 

table 14 
selector channel mode 16 
shadow page table 14 
shadow table 14 



10 



shared 

segment, protection 

systems 9-10 
sharing 

devices 

segments 

systems 



10 



15 

10.14.21 
9-10,14 

single-user systems, supported 6 
software system supported for RSCS 29 
spool files 

closing CP 19 

input 16 

output 17 
spooling 

files, with RSCS 27 

options 17 

remote 17 

Uuxt recoru I/O i6 

virtual console I/O 17 
START I/O instruction 15 
START I/O operation, simulated by CP 16 
storage 

auxiliary 6 

management of 13 

of virtual machine 13 

real, size of 14 

size 

defining 13 
maximum 13 
normal 13 

virtual 2,6 
supervisor, RSCS 27 
supervisor state 13,15 
support, of system 8 
system 

attached processor 18 

backup 8 

generation 7 

shared 14 

support 8 

support for 

attached processor (AP) 18 
RSCS teleprocessing network 29 

testing 6-7 
system requirements (see Virtual Machine 

Facility/370, system requirements) 
systems 

programming 6 

saved 9-10 

shared 9-10 



T 

table 

page 14 
segment 14 
shadow 14 



Index 45 



TCU (See transaission control unit) 
teleprocessing hardware requirements, RSCS 

27 
temporary use, of virtual device 15 
testing, of system 6-7 
third level storage 14 
time, management 13 
time sharing 21 
time slice 13 
time slicing 13 
time-sharing 6 
transferring, files 17 

translating, virtual storage address 16 
transmitting 

commands, with RSCS 29 

files, with RSCS 29 
typical CMS configuration 21 



unit record devices, virtual 4 
user 

conversational, definition of 13 

disk, CMS 22 

general 17 

identification 5 

nonconversational, definition of 13 
user directory ( see VM/370 directory) 
user files, CMS 21,22 
userid 5 



7 
virtual 

channel-to-channel adapter H 

devices 

access to 15 
dedicated 11 
operation of 15 
shared 15 

disks 4 

I/O devices 3 

processor 3 

storage 2 

system console 3 

unit record devices 4 
virtual=real, description of 8-9 
virtual=real option 8-9,14 
virtual lines 4 
virtual machine 

accounting 9-10 

communication facility 11 

creation of 13 
virtual machine assist, description of 8 



Virtual Machine Communication Facility 

(VMCF) 19 
Virtual Machine Facility/370 
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